Перейти к основному содержимому

Нажатие UI-элемента (ui_element.click)

Функция доступна в версиях после 20260507.

Объявление​

состояние, информация_или_ошибка = ui_element.click(селектор_или_элемент [, параметры ])

Параметры​

  • Селектор или элемент
    Таблица: селектор, элемент, возвращённый поиском, или таблица координат { x = абсцисса, y = ордината }.
  • Параметры
    Необязательная таблица; см. описание общих параметров.

Возвращаемое значение​

  • Состояние
    Логическое значение: при успехе true, при ошибке nil.
  • Информация или ошибка
    При успехе таблица с информацией о действии, при ошибке строка с причиной.

Описание​

Нажимает кнопки, элементы списка, клавиши клавиатуры и другие доступные для нажатия UI-элементы. Координаты в таблице указаны в физических пикселях. Для нажатия по фиксированным координатам предпочтительно используйте touch.tap. Если совпадает несколько целей и нельзя определить единственную, может возвращаться nil, "ambiguous target".

Пример​

local ui_element = require("ui_element")

local ok, info_or_err = ui_element.click({
title = "继续",
role = "button",
})

if not ok then
sys.toast(info_or_err)
end

Примечание: приведённый код использует функцию из другого раздела sys.toast